home *** CD-ROM | disk | FTP | other *** search
/ Developer CD Series 2000 August: Tool Chest / Dev.CD Aug 00 TC Disk 2.toast / pc / sample code / human interface toolbox / packagetool / readme < prev    next >
Encoding:
Text File  |  2000-06-23  |  4.7 KB  |  110 lines
  1. PackageTool 1.3
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11. PackageTool is an application illustrating how to create application packages in Mac OS 9.  It provides a simple interface for converting correctly formatted folders into packages and vice versa.  
  12.  
  13. Copyright © 1999 by Apple Computer, Inc.
  14. All Rights Reserved.
  15.     
  16. Disclaimer:
  17. You may incorporate this sample code into your applications without restriction, though the sample code has been provided "AS IS" and the responsibility for its operation is 100% yours.  However, what you are not permitted to do is to redistribute the source as "DSC Sample Code" after having made changes. If you're going to re-distribute the source, we require that you make it clear in the source that the code was descended from Apple Sample Code, but that you've made changes.
  18.  
  19. Features in version 1.3:
  20. • Revisited the UpdateRelativeAliasFile routine defined in Utilities.h to include an optional create-if-necessary parameter.  It has been enhanced to it is possible to use it to create alias files referring to folders.
  21. • Better CarbonLib combatibility.
  22. • Revisited the package conversion code in PackageWindow.c making it so it performs better verification of folders before attempting to turn them into packages.
  23.  
  24. Features in version 1.2:
  25. • Added navigation services dialogs.
  26. • Fixed up some CarbonLib incompatibilities.
  27. • Added routine NavReplyToODOCList to Utilities.c that shows how to convert document lists returned by Navigation Services into document lists that have the same format and contents as the ones the Finder passes to your application's 'odoc' Apple event handler.  The idea here being that your application only needs to have one document opening routine once the two lists have been converted to the same format.
  28.  
  29. New features in version 1.1:
  30. • This version of the PackageTool was compiled with CarbonLib.
  31. • A bug in the Alias Manager makes it impossible to create a 'relative alias' file that refers to a file in the same directory.  As a result, it is not possible to create a Mac OS 9 package where the alias refers to a file in the package's root directory.  However, since the ResolveAliasFile routine uses the alias file itself as the relative file when resolving targets, and, when resolving alias chains, it will use each alias file along the way as the relative file, there is a work around that will allow you to place the package's main file in the package's root directory.   Here, it is necessary to create a sub-directory and use two alias files as shown below:
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48. The PackageTool sample has been revised so that when it finds a situation where the main file is in the package's root directory, it will automatically create a sub-directory and build the alias chain for you.
  49. • Calls to the standard C library have been removed from the sources.
  50. • The dlgx resources were modified so the dialog manager now creates a control heirarchy when creating the main window.  This was done because under Mac OS X, the user item is not drawn unless a control heirarchy is built.
  51.  
  52. Features in version 1.0:
  53. Mac OS 9 Package Related techniques illustrated include:
  54. • how packages can be created,
  55. • how to detect packages,
  56. handling packages appropriately in drag handlers.
  57.  
  58. Other interesting techniques illustrated include:
  59. • retrieving icons for files,
  60. • graying out a section of a window
  61.  
  62. Files:
  63.  
  64. :obj: - compiled object files.
  65.  
  66. ':PackageTool.prj Data:' - CodeWarrior project data.
  67.  
  68. ':Sample Package:' - an example package including the 'package aware' HTMLSample application.  Therein you will find an example package document and an example package application.
  69.  
  70. MakeFile - MPW make file.
  71.  
  72. PackageTool - the PackageTool application.
  73.  
  74. PackageTool.c - main program and event dispatching for the PackageTool application.
  75.  
  76. PackageTool.h - constant definitions and routine prototypes for the PackageTool application.
  77.  
  78. PackageTool.prj - CodeWarrior project file for building the application.
  79.  
  80. PackageTool.r - MPW Rez file the the application.
  81.  
  82. PackageTool.rsrc - ResEdit resource file for the resources used in the application.
  83.  
  84. PackageUtils.c - Utilities package savy applications can use for identifying packages.
  85.  
  86. PackageUtils.h - routine prototypes for routines defined in PackageUtils.c.
  87.  
  88. PackageWindow.c - routines implementing the window displayed by the PackageTool application.
  89.  
  90. PackageWindow.h - routine prototypes for routines defined in PackageWindow.c.
  91.  
  92. 'Re- C/F Registration Request' - creator file type registration for the PackageTool application.
  93.  
  94. ReadMe - see ReadMe.
  95.  
  96. SimplePrefs.c - routines for implementing preferences files as a datafork containing a flattened collection.
  97.  
  98. SimplePrefs.h - routine prototypes for routines defined in SimplePrefs.c.
  99.  
  100. Utilities.c - utility routines set aside to simplify the main example.
  101.  
  102. Utilities.h - routine prototypes for routines defined in Utilities.c.
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.